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This Technical Note presents short 65816 assembly language examples illustrating pitfalls and 
clever techniques. 

Changes since November 1990: Added more explanations about the JSL table and corrected a 
comment. 




Dispatching Through an Address Table 

The 65816 has a JSR ( $aaaa , X ) instruction for calling a selected subroutine from a table of 
addresses, but it has no JSL ( $aaaa , X ) instruction. If you need to dispatch to one of several 
routines that are not all in the same bank, you need an approach like the following. The idea is to 
perform a JSL to a routine which does a long jump by pushing a three-byte "RTL address" on 
the stack and then doing an RTL. 



jsl LngJmp 



;go jump to the routine 



LngJmp 



table 



asl a 
asl a 
tax 

Ida table+l,x 
pha 

Ida table, x 
dec a 
phb 

sta l,s 
rtl 

del routinel 
del routine2 
del routine3 



take routine number in A and 

multiply it by 4 
put table index into X 
get "middle" word of address 

and push it 
get low word and 

decrement it by one 
push a single throw-away byte 
store over low two of the 3 bytes 
transfer control to the routine 
table of 4-byte subroutine addresses 



This code is correct because RTL pulls three bytes off the stack and increments the two low bytes 
without incrementing the high byte. 



Note: This approach to a table-based JSL is more flexible than JML ( $XXXX ) because it does 
not require any fixed-location storage or bank zero space, other than the stack. 
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On the other hand, the following code is not correct. The approach here is to make a table of 
addresses minus one. 



as 1 a 




w 




asl a 




R 


;multiply index by 4 


tax 







; and put it in X 


Ida table+l,x 




N 


;get the "middle" word 


pha 




G 


; and push it 


Ida table, x 




i 


; get the low word 


phb 




W 


;push a single throw-away byte 


sta l,s 




R 


; store over low two bytes 


rtl 







; transfer control to the routine 


del routinel- 


1 


N 


; table of 4-byte addresses minus one 


dc.l routine2- 


1 


G 




dc.l routine3- 


1 


i 





This second sample code fragment fails if any of the routines in the table comes at the first byte 
of a bank. For example, if routine 1 is at $060000, the address pushed is $05FFFF, and RTL 
transfers control to $050000, not $060000. 

Dereferencing Handles Without Direct Page Space 

When your code gets called with the D register undefined, you must not use direct page 
addressing without setting D to a known good value. Preserving and restoring locations on the 
caller's direct page is not reliable, because D could be pointing at bytes below the stack pointer 
(which can be destroyed by interrupts) or even at the $C0xx soft switches (that would make your 
direct page accesses accidentally fiddle with hardware). 

A common way to get temporary direct page space is to point D at part of your stack. This 
following code dereferences a handle stored in the A and X registers (if the handle is $E01234 
and refers to a block of memory at $056789, then on entry A=$00E0 and X=$1234, and on exit 
A=$0005 and X=$6789). 



phd ;save caller's direct-page register 

pha ;push high word of handle 

phx ;push low word of handle 

tsc ;get stack pointer in A 

ted ;and put it in D 

Ida [1] ;get low word of master pointer (no ",Y"!) 

tax ; and put it in X 

ldy #$0002 ; offset to high word of master pointer 

Ida [l],y ;get high word 

ply ; remove low word of handle 

ply ; and high word 

pld ; restore the caller's direct-page register 
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Direct page addressing isn't the only way to address through pointers. Here's the same routine 
as before, but using the Data Bank register (B) instead of fiddling with D. (Note that handles do 
not have to be in bank $E0 or $E1, although they usually are.) 



Emulation Mode Has 65816 Features 

You don't have to switch into Native mode just to do an eight-bit operation with long addressing. 
Most 65816-specific instructions and addressing modes work in emulation mode in 
approximately the same way they work in eight-bit native mode. See the "Further Reference" 
for details. 



Further Reference 

• Apple IlGS Hardware Reference 

• Programming the 65816, Including the 6502, 65C02 and 65802 (Eyes and Lichty, 1986, 



tax 
pla 
plb 
plb 



phb 
pha 
plb 



Ida | $0002, x 
pha 

Ida | $0000, x 



;save caller's data bank register 

;push high word of handle on stack 

;sets B to the bank byte of the pointer 

; load the high word of the master pointer 

; and save it on the stack 

; load the low word of the master pointer 

; and return it in X 

; restore the high word in A 

;pull the handle's high word high byte off the stack 
; restore the caller's data bank register 



Brady) 
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